home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 27 / CU Amiga Magazine's Super CD-ROM 27 (1998)(EMAP Images)(GB)[!][issue 1998-10].iso / CDSupport / UpDateCopy / Docs / UpDateCopy.dok < prev    next >
Text File  |  1998-03-18  |  9KB  |  227 lines
  1.  
  2.                         Dokumentation für UpDateCopy
  3.  
  4.                           Version 1.5 - 17.03.1998
  5.                    $VER: UpDateCopy.dok 1.5 (17.03.1998)
  6.  
  7.  
  8.                        Geschrieben von Sven Steiniger
  9.                                -- Cardware --
  10.  
  11.  
  12. ------------------------------------------------------------------------------
  13.                                  Einführung
  14. ------------------------------------------------------------------------------
  15.  
  16.     UpDateCopy ist eine Erweiterung des Standard copy Kommandos. Es
  17.     kopiert nicht nur Dateien und erzeugt (wenn notwendig) Verzeichnisse
  18.     sondern bearbeitet auch schon existierende Dateien: ältere Dateien
  19.     werden automatisch durch neuere ersetzt. UpDateCopy sucht erst nach
  20.     nach der Versionszeichenkette ($VER: Programmname Version.Reversion)
  21.     in der Datei und überschreibt nur Dateien mit höherer Versionsnummer.
  22.     Findet UpDateCopy keine Versionsnummern vergleicht er das Datum der
  23.     Dateien und erzetzt wenn nötig. Außerdem kann auch das 'Archive'
  24.     Schutzbit überprüft/gesetzt werden.
  25.     UpDateCopy verarbeite außerdem mehrere Quelldateien, Namensmuster
  26.     und rekursive Verzeichnisdurchsuchung.
  27.  
  28. ------------------------------------------------------------------------------
  29.                            Systemvorraussetzungen
  30. ------------------------------------------------------------------------------
  31.  
  32.     - einen Amiga :-)
  33.     - mindestens KickStart 2.04
  34.     - asyncio.library v39
  35.  
  36.  
  37. ------------------------------------------------------------------------------
  38.                                 Installation
  39. ------------------------------------------------------------------------------
  40.  
  41.     Einfach 'UpDateCopy' nach 'C:' kopieren und 'libs/asyncio.library'
  42.     nach 'LIBS:'.
  43.  
  44.  
  45. ------------------------------------------------------------------------------
  46.                                  Benutzung
  47. ------------------------------------------------------------------------------
  48.  
  49.  
  50.     Befehlsformat:
  51.         UpDateCopy [FROM] {<sourcename|sourcepattern>} [TO] <destname>
  52.                        [QUIET] [ALL] [FORCE] [DEEP] [NODATECHECK]
  53.                    [TESTMODE] [CLONE] [PAPF] [SMARTINFO] [FAST]
  54.                    [NOASK] [CHECKARCBIT] [SETARCBIT] [PRECISEDS]
  55.  
  56.     Befehlsschablone:
  57.         UpDateCopy FROM/M,TO/A,QUIET/S,ALL/S,FORCE/S,DEEP/S,
  58.                    NDC=NODATECHECK/S,TESTMODE/S,CLONE/S,PAB=PAPF/S,
  59.                    SMARTINFO/S,FAST/S,NOASK/S,SAB=SETARCBIT/S,
  60.                            CAB=CHECKARCBIT/S,PRECISEDS/S
  61.  
  62.  
  63.     Parameter:
  64.         sourcename, sourcepattern
  65.             Die Namen der zu kopierenden Dateien und Verzeichnisse
  66.             (auch Namensmuster).
  67.         destname
  68.             Name des Zielverzeichnisses.
  69.         QUIET
  70.             Schaltet die Ausgabe aus. Es werden nur nur Fehler-
  71.             meldungen angezeigt.
  72.         ALL
  73.             Wenn diese Option angegeben wird, durchsucht
  74.             UpDateCopy auch die Unterverzeichnisse; wenn nicht
  75.             dann nur Dateien und Verzeichnisnamen des Quell-
  76.             verzeichnisses.
  77.         FORCE
  78.             Normalerweise können Lösch-geschützte Dateien nicht
  79.             überschrieben werden. Wenn du diese Option an-
  80.             wählst ignoriert UpDateCopy diese Schutzbits.
  81.         DEEP
  82.             UpDateCopy vergleicht nur das Datum der Dateien.
  83.             Mit der DEEP-Option untersucht UpDateCopy die Dateien
  84.             erst nach Versionsnummern ($VER:) und vergleicht
  85.             diese. Nur wenn keine Versionsnummern zu finden sind,
  86.             wird das Datum verglichen.
  87.             Merke: Obwohl dieser Suchealgorithmus in Assembler
  88.                    geschrieben ist, verlangsamt diese Option das
  89.                    Programm teilweise erheblich.
  90.         NODATECHECK
  91.             Schaltet das Vergleichen des Datums aus.
  92.             Merke: Wenn diese Option angegeben wird, wird der
  93.                    DEEP-Scanmodus automatisch eingeschaltet.
  94.         TESTMODE
  95.             Schaltet den Testmodus ein. UpDateCopy kopiert/ersetzt
  96.             ältere Dateien nicht mehr und Verzeichnisse werden
  97.             auch nicht mehr angelegt. Dabei sind die Ausgaben
  98.             jedoch die selben wie ohne Testmodus. Diese Option
  99.             kann fürs einfache Vergleichen von Verzeichnissen
  100.             nützlich sein.
  101.         CLONE
  102.             Wenn diese Option angegeben wird kopiert UpDateCopy
  103.             das Datum von der Quelldatei.
  104.         PAB
  105.             Normalerweise löscht UpDateCopy das Archive-Schutzbit
  106.             bei kopierten Dateien. Wird diese Option angegeben
  107.             wird dieses Bit nicht verändert.
  108.             Bemerkung: UpDateCopy kopiert immer
  109.                     - die Schutzbits (außer Archive)
  110.                     - und den Dateikommentar.
  111.         SMARTINFO
  112.             UpDateCopy zeigt keine unveränderten ('skipped')
  113.                         Verzeichnisse und Dateien an.
  114.         FAST
  115.             Schaltet den Zeilenvorschub ab. Damit wird die
  116.             Bearbeitung vieler kleiner Dateien viel schneller, da
  117.             das Rollen der Anzeige länger als das Durchsuchen
  118.             dauert.
  119.         NOASK
  120.             Wenn ein Fehler auftritt, fragt UpDateCopy
  121.             normalerweise was es tun soll. Wird diese Option
  122.             angegeben, beendet sich das Programm automatisch.
  123.         CHECKARCBIT
  124.             Kopiert Dateien/Verzeichnisse nur, wenn ihr
  125.             Archive-Bit *nicht* gesetzt ist.
  126.             Normalerweise wird dieses Bit immer gelöscht, wenn
  127.             eine Datei verändert wird. In Verbindung mit
  128.             SETARCBIT können veränderte Dateien leicht kopiert
  129.             werden.
  130.             Bem.:    Auf Dateien mit einem gelöschten Archive-Bit
  131.                 werden alle Vergleichsmethoden (Datums-
  132.                 vergleich, DEEP) angewendet.
  133.         SETARCBIT
  134.             Setzt das Archive-Bit bei allen kopierten Dateien/
  135.             Verzeichnissen.
  136.         PRECISEDS
  137.             Das Datum wird jetzt exakt verglichen.
  138.             Normalerweise werden die Sekunden so konvertiert, daß
  139.             sie ein Vielfaches von 2 sind. Das ist was lha macht
  140.             und man wird normalerweise nichts davon merken, es sei
  141.             denn eine Datei mit dem Datum 14:03:44 soll durch eine
  142.             mit 14:03:45 ersetzt werden, was nicht funktionieren
  143.             wird (aber auch extrem selten auftritt).
  144.  
  145.     Beispiele:
  146.         UpDateCopy #? ram:T
  147.             Kopiert alle Dateien des aktuellen Verzeichnisses nach
  148.             "ram:T". Nicht existierende Dateien werden kopiert,
  149.             nicht existierende Verzeichnisse werden erzeugt.
  150.             Existierende Dateien werden nur überschrieben, wenn
  151.             sie älteren Datums sind.
  152.         UpDateCopy #? ram:T ALL
  153.             Das selbe wie vorher aber UpDateCopy untersucht jetzt
  154.             auch Unterverzeichnisse.
  155.         UpDateCopy #? ram:T DEEP
  156.             Wie das erste Beispiel aber UpDateCopy vergleicht
  157.             nicht nur das Datum sondern vorher die Versionsnummern
  158.             (wenn vorhanden).
  159.         UpDateCopy #? ram:T DEEP NDC
  160.             Wie das erste Beispiel aber UpDateCopy vergleicht
  161.             nur die Versionsnummern. Wird keine Versionsnummer
  162.             gefunden kopiert/ersetzt UpDateCopy keine Dateien
  163.             auch wenn sie neueren Datums sind. Auch nicht
  164.             existierende Verzeichnisse werden nicht angelegt.
  165.         UpDateCopy #?.info #?.e TO=ram:T ALL DEEP esource:3D/Plotter3D
  166.             Kopiert all Dateien des aktuellen Verzeichnisses nach
  167.             "ram:T" welche mit ".info" oder ".e" enden. Auch
  168.             Unterverzeichnisse werden untersucht und die Datei
  169.             "esource:3D/Plotter3D" wird kopiert.
  170.         UpdateCopy sys: TO backup: ALL CAB SAB SMARTINFO
  171.             Das ist meine normale Backup-Routine. Es werden nur
  172.             geänderte Dateien (Archive-Bit) kopiert, das
  173.             Archive-Bit wird dort gesetzt und eine Liste aller
  174.             kopierten Dateien wird angezeigt.
  175.  
  176. ------------------------------------------------------------------------------
  177.                                    Author
  178. ------------------------------------------------------------------------------
  179.  
  180.     Schicke Fehlerreports, Ideen, usw. an:
  181.  
  182.                                Sven Steiniger
  183.  
  184.                               Rathener Str. 29
  185.                                01259 Dresden
  186.                                 Deutschland
  187.  
  188.                        Email: ss37@inf.tu-dresden.de
  189.  
  190. ------------------------------------------------------------------------------
  191.                                Copyright etc.
  192. ------------------------------------------------------------------------------
  193.  
  194. UpDateCopy ist CARDWARE, das bedeutet dass du mir eine Email schicken
  195. solltest, wenn du dieses Programm benutzt. Auch kleine Geschenke sind immer
  196. willkommen.
  197.  
  198.  Copyright
  199. -----------
  200. UpDateCopy wurde geschrieben von Sven Steiniger. Du kannst den Quelltext frei
  201. in deinen eigenen Programmen verwenden oder ihn einfach erweitern. Aber, bitte
  202. verbreitet eine modifizierte Version nicht unter diesem Namen (UpDateCopy),
  203. Wenn der Quelltext zu etwas nützlich war, würde ich mich über eine Kopie des
  204. Programms freuen.
  205.  
  206.  Verbreitung
  207. -------------
  208. Dieses Programm kann frei verbreitet werden solange der Archiv-Inhalt nicht
  209. verändert wird and keinerlei Profit damit gemacht wird.
  210. Archiv-Inhalt:
  211.     UpDateCopy/UpDateCopy        - die ausführbare Datei
  212.     UpDateCopy/Source/UpDateCopy.e    - der Quelltext (AmigaE)
  213.     UpDateCopy/Docs/UpDateCopy.doc    - Englische Dokumentation
  214.     UpDateCopy/Docs/UpDateCopy.dok  - Deutsche Dokumentation
  215.     UpDateCopy/Scripts/BackUpUp     - Backup-Skript von Attilio Scifoni
  216.     UpDateCopy/Scripts/BackUpUp2    - modifiziertes BackUpUp-Skript
  217.     UpDateCopy/Scripts/BackUpUp_GUI - BackUpUp2 mit Requestern
  218.     UpDateCopy/Scripts/BackUpUp.doc - englische Beschreibung der Skripte
  219.     UpDateCopy/readme        - Kurzinformation Englisch
  220.     UpDateCopy/liesmich        - Kurzinformation Deutsch
  221.  
  222.  
  223.  Haftung
  224. ---------
  225. Ich (der Author) bin in keiner Weise für Schäden, die direkt oder indirekt
  226. durch dieses Programm erzeugt wurden, verantwortlich.
  227.